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LiveCode 9.0 enables access to libraries and platform APIs written in many other languages 
thanks to the community-funded ‘Infinite LiveCode' project. 


This includes a greatly improved LiveCode Builder virtual machine. 


LiveCode 9.0 contains many additional improvements to support LiveCode app developers, 
including: 


e Anew "spinner" widget 
e OAuth2 authentication library for use with web APIs (e.g. Facebook, Google and GitHub) 
e Acommand argument parser library for building command-line standalones 


e Updates and performance improvements for existing widgets 


Known Issues 





e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording. 
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Boolean constants 


In this release, boolean constants true and false have been changed so that they resolve to 


values of boolean type (rather than string). This will affect any uses of the 1S strictly operator 
on such values, i.e. previously the following were true: 


true is strictly a string false is strictly a string 


Now, they are both false, and the following are true: 
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true is strictly a boolean false is strictly a boolean 


Boolean constants passed as elements of arrays to LCB handlers will not require conversion to 
boolean values in LCB - in fact any attempt to do so assuming they are strings will cause an error. 
Any array elements which are intended to be booleans in LCB should be checked for their type 
before conversion. For example, any of the following could be done by an LCB library user: 


put true into tArray["enabled" ] 
put "true" into tArray["enabled" ] 
put (tVar is not "“enabled") into tArray["enabled" | 


An LCB handler to which tArray is passed should do the following: 


variable tEnabled as Boolean 
if tArray["enabled"] is a boolean then 
put tAction["enabled"] into tEnabled 
else 
put tAction["enabled"] parsed as boolean into tEnabled 
end if 


Infinity constant 


The constant infinity has been added to the language in this release. As a result, the 


unquoted literal infinity is nowreserved. Any existing uses of it should be quoted, as otherwise 
it will resolve to the floating point value representing infinity, rather than the string “infinity”. 


Implicit object 


A number of LCB commands use an implicit object to provide context for their execution. Some of 
these commands also allow specifying an explicit object. These commands are: 


e execute script 

e send 

e post 

e image from file 

e resolve file - newin this version 


In previous releases execute script and image from file would use 

this card of the defaultStack as the implicit object even if called from a widget. The send 
and post commands, however, used this card of the defaultStack when in a library 
module handler and the host widget when in a widget module handler. This release changes 
execute script and image from file to also use the host wdget as the implicit object. This 
means, for example, that image from file will resolve a relative file path relative to the 
StackFile the host wdget is on rather than the stackFile of the defaultStack. 
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The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows 7 (both 32-bit and 64-bit) 
e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 


Note: On 64-bit Windows installations, LiveCode can run either as a 32-bit application through the 
WoW layer or as a native 64-bit Windows application, depending on the installer that is chosen. 


Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [Server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


o0 GTK/GDK 2.24 or later 

o Pango with Xft support 

°o esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

°o Icms (optional, required for color profile Support in images) 
° gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 
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Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 
The Mac engine supports: 


e 10.9.x (Mavericks) 
e 10.10.x (Yosemite) 
e 10.11.x (El Capitan) 
e 10.12.x (Sierra) 

e 10.13.x (High Sierra) 
e 10.14.x (Mojave) 

e 10.15.x (Catalina) 

e 11.x (Big Sur) 
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IOS 
iOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 9.2 on MacOS 10.12 (Note: You need to upgrade to 10.12.6) 

e Xcode 10.1 on MacOS 10.13 (Note: You need to upgrade to 10.13.4) 

e Xcode 11.3 on MacOS 10.14 (Note: You need to upgrade to 10.14.4) 

e Xcode 12.4 on MacOS 10.15 and above (Note: You need to upgrade to 10.15.4) 
e Xcode 12.5 on MacOS 11.0 and above 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
Simulators. For instance, on MacOS 10.13 (High Sierra), you can add Xcode 9.2 in the Mobile 
Support preferences, to let you test your stack on the iOS Simulator 11.2. 


We currently support building against the following versions of the iOS SDK: 


e 11.2 (included in Xcode 9.2) 

e 12.1 (included in Xcode 10.1) 
e 13.2 (included in Xcode 11.3) 
e 14.4 (included in Xcode 12.4) 
e 14.5 (included in Xcode 12.5) 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using x86, x86-64, ARM and ARM64 processors. It will run on 
the following versions of Android: 
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e 5.0-5.1 (Lollipop) 
e 6.0 (Marshmallow) 
e 7.x (Nougat) 

e 8.x (Oreo) 

e 9.0 (Pie) 

e 10.0 (Q) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the 'Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
“openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not officially supported. 


HTMLS5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTML5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


Setup 





Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS xX, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 


Windows <x86 program files folder>/RunRev/LiveCode <version> 
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bitform /opt/livecode/livecode -<Pathion> 


The installations when installing for "This User" are: 


Platform Path 

Windows  “USer roaming app data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/livecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS X, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 
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Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install -ui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 


Install the IDE for "All Users". If not specified, LiveCode will be installed 


-allusers 
for the current user only. 


Place a shortcut on the Desktop (Windows-only) 


desktopshortcut 

-startmenu Place shortcuts in the Start Menu (Windows-only) 

-location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 

leap aik= nee ae to log installation actions. If not specified, no log is 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <installer> install -ui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 
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Run the uninstaller using a command of the form: 
<uninstaller> uninstall -ui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 


given SECRET passphrase, and installs a license file for all users of the computer. Manual 
activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<Livecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <livecode> activate -file LICENSE -passphrase SECRET 
Start /wait <livecode> deactivate 


On Mac OS X, you need to do: 
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<Livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<Livecode>/Contents/MacOS/LiveCode deactivate 
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Support for App Tracking Transparency 


The Standalone Builder now includes a checkbox that adds support for App Tracking 

Transparency. This is a requirement if your app collects user data that is shared among apps or 
websites. Moreover, a text field is added, where you can provide the usage description string, i.e. 
the dialog text that will be presented to the user letting them know that their data will be shared. 


Allow background location updates 


A newcommand iphoneAllowBackgroundLocationUpdates has been added, which can be 


used to allowdisallow location updates when the app is suspended. This command has an effect 
only if "Location Update" is checked in the "Background Execution" section in the iOS standalone 
settings. 


Specific engine bug fixes (9.6.3-rc-2) 


23038 Fixsome images rendering as black in recent macOS versions 


Specific engine bug fixes (9.6.3-rc-1) 


14944 Corrected text errors in the XML section of the User Guide. 

16296 Fix crash on Android when restarting the location tracker 

An issue causing $ POST RAW on Windows to not be set for large uploads has been 
fixed. 

21615 Add HIDPI scaling support to HTML5 engine 

Added new function iphoneDeviceModel() that returns the machine name of the iOS 
device the app is running on 

Fix blank image created when pasting image data from some applications on 
Windows 


16745 


21769 


21906 


21982 Ensure the printersettings always return the user's choice 
Fix black screen on Android when navigating between cards with 
acceleratedRendering enabled 


Fix codesigning error saving Mac standalone app when the app name contains 
accented characters 


22868 Ensure format() function recognizes a negative format length 


22305 


22791 
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22990 
22999 
23015 
23016 
23030 
23044 
23050 


23055 


23064 
23067 
23068 
23074 
23089 
23094 


23096 


23098 
23100 
23104 
23126 
23130 


23150 


23160 
23166 
23167 
23168 
23183 
23193 
23208 
23212 


23220 


23232 
23240 
23247 
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Fix crash in HTML5 standalones when loading certain custom TTF font files 

Fix background location updates on iOS 

Fixed text display issue with audioClip. 

Fix 'fontnames' always returning empty in HTML5 standalones 

Enable WebRTC on CEF browser 

Fix crash when deleting the current card of a stack within its closeStack handler 
Updated SQLite to version 3.34.0 

Allow seek command to reset "eof" result after read command reaches the end of a 
file on macOS 

Add support for building apps against iOS 14.4 SDK 

Added page reload note to browser URL docs 

Updated release notes for how LiveCode runs on Windows 

Added holderVariable note to revDatabaseColumnNamed docs 

Fix Browser Widget being resized to fit group instead of being clipped 

Ensure android native layer rects are updated when their parent view is resized 
Fix a significant delay when using AppleScript to target some Applications when 
running on M1 architecture macs 

Native layers now relayer correctly in response to the relayer command 

Fix rendering of mobile player when acceleratedRendering is true 

Ensure player's native layer rectangle does not change when stack is resized 
Marked revVideoGrabber dictionary entries as deprecated. 

Ensure mobilePickDate shows the pick wheel on iOS 14+ 

Ensure urlWakeUp message is sent when LSSupportsOpeningDocumentsInPlace 
is set to true in Info.plist 

Corrected code example in the revXMLEvaluateXPath entry 

Fix memory leak when parsing visual effect command arguments 

Fix memory leak when using arrayEncode with encodeVersion less than 7.0 

Fix memory leak when rendering gradients where the quality is set to "good" 
Add support for building apps against iOS 14.5 SDK 

Added support for App Tracking Transparency on iOS 

Ensure new stacks always open in new windows on macOS 

Ensure mobileExportImageToAlbum works on Android 7+ devices 

Ensure clicking in an image rect in pointer mode does not send mouseRelease 
instead of a mouseUp message 

Corrected code example in documentation for replace. 

Fix IDE lockup when an execution error occurs in a modal stack 

Removed all references to HTML5 from the post entry. 
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Specific IDE bug fixes (9.6.3) 
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23257 Fix build error on Android when ‘Allow Http Connections' button is 
checked 


Specific IDE bug fixes (9.6.3-rc-1) 


22300 Ensure right-clicking on the Project Browser object list selects the correct row 
22400 Added support for unblocking http requests on Android browser 

22979 Added dgRectOfindex and dgRectOfLine to DataGrid documentation 

23202 Added missing property dgLineOflndex to documentation. 

23219 Extensionbuilder: enable display of defaultScript and userguide 

23221 Enable show names in svgiconPicker when used in Properties Inspector 
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Specific extension bug fixes (9.6.3-rc-1) 


22808 Use default browser instead of browser widget to show the OAuth2 dialog on Linux 
23056 Prevent error when values hidden and moving over right side of widget 

23061 Showname of chosen icon when opening the icon picker 

23223 Add name of SVG Icon to Properties Inspector 
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Specific engine bug fixes (9.6.3-rc-1) 


22714 Include dual and triple camera capture devices when listing videoDevices on iOS 
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Specific extension bug fixes (9.6.3-rc-1) 


32749 Ensure the correct supported platforms are listed for the Map widget in the Inclusions 
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LiveCode Business extension changes 





Specific extension bug fixes (9.6.3-rc-1) 


22941 Fix error when clicking on a PDF widget with empty fileName or fileData 
23069 Fix Android PDFium library build issue causing widget not to function 
23070 Fix crash on iOS initializing the PDF widget 
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e iphoneAllowBackgroundLocationUpdates (command) has been added to the 
dictionary. 

e iphoneDeviceModel (function) has been added to the dictionary. 

e iphoneTrackingAuthorizationStatus (function) has been added to the dictionary. 
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